Chapter 4-8: Runtime Subroutine's and Predefined Processes |
.STREAM READ This subroutine is called to read a file stream. Usage: (Option 1)
Usage: (Option 2, 5.3.2 or later only)
Description: This subroutine is called to read a file stream previously opened for READ access via .STREAM OPEN. The first two parameters are required, and the subroutine will CANCEL if they are are not all received. The <read_length> and <length_read> parameters are optional. <read_buffer> contains the data read from <stream_name> (Required). This subroutine can read lines up to a maximum of 32000 characters long. This must be passed SHARED to return any data. <stream_name> is the name of the previously opened stream (Required). <read_length> is the number of bytes to read (optional). If not passed it will read up until a line termination character to a maximum of 32000 characters. If a value is passed it will read up to that number of characters or until a line termination character is encountered, whichever comes first. In Option 1, if passed shared, it will return the number of characters actually read, however, you should set it back to 32000 before the next GOSUB --- .STREAM READ, otherwise this subroutine will only read that number of characters (or less). If you PASS <length_read> as in Option 2, this will value not return anything and will not change, even if passed SHARED. In this case, the number of bytes read will be returned in <length_read>. <length_read> is the number of characters actually read (5.3.2 and higher only). This must be passed SHARED to return a value. If --- .STREAM READ contains 'Data was truncated', it means the <read_buffer> field you passed was not large enough to contain all the data that was read. If --- .STREAM READ contains 'EOF', then there is no more data to be read. |
Application Design Manual "Powered by Appx Software"1263 ©2006 By APPX Software, Inc. All Rights Reserved |
